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FIELD NOTE A WORKING PAPER 



The views, conclusions, and recommendations expressed 
herein do noc necessarily reflect the official views or poli- 
cies of either the Air Force or the System Development 
Corporation. 
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Although this working paper contains no classified infor- 
mation it has not been cleared for open publication by the 
Department of Defense. Open publication, wholly or in 
part, is prohibited without prior approval of the System 
Development Corporation. 



(Produced under System Development Corporation sub- 
contract No. 202 issued by International Electric 
Corporation in performance of contract AF-30(635>)-ll583) 
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SYSTEM SPECIFICATIONS 

FOR THE 

JOVIAL INTERPRETER SYSTEM 



INTRODUCTION 

i i iBfesasss 



The purpose of this document is to include, in one ready reference, 
general system specifications that are not readily apparent from a reading 
of other documents on the JOVIAL Interpreter System (JIS). Such topics 
as the organization and format of the master tape, identification con- 
ventions for JIS programs, a brief description of the operation of JIS, 
tape allocation, permanent core allocation, sense indicators, and sense 
switch settings are included. 
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JOVIAL | IN TERPRETS SYSTEM (JIS) FUNCTIONS AND OPERATION 

All operations of JIS are supervised by the Test Control Program, 
JTCPZ, the primary purpose of which is to control the operation of the sub- 
programs in JISo 

JIS' main function is the testing of JOVIAL object programs. JIS 
also performs two support functions «, The first support function is provided 
by a tape-loading program, JMSTZo This program accepts control card inputs 
and uses this control data to produce a System Master Tape. This tape is 
created by a selective duplication process which copies programs and data 
from various input sources,, such as binary decks and binary tapes, and orders 
them onto the output tape. The second support function is that of assembling 
the data definitions needed to create a Master Compool. The Assemble Master 
Compool Program, JAMCZ, accepts input cards which describe common data<> It 
uses the information from these cards to produce the Master Compool, which 
is then used by the tape-loading program, JMSTZ. 

The major function of JIS, as was mentioned above, is the checking 
of the logic of JOVIAL-coded programs <, All input data cards are either pre- 
stored off-line onto tape, or are introduced via the card reader. Different 
tests may be stacked, with the sequence of job operation being controlled 
by a deck of test control cards in the card reader o Control card data is 
used by JTCPZ to select the proper input data and to initiate the test. If 
at any time during the testing cycle the intermediate results indicate that 
further operation would be meaningless, the test is discontinued and another 
operation is initiated 

The first JIS subprogram to operate is known as the First Pass of 
the Interpreter ( JALLZ )o The JOVIAL input cards are read in by JALLZ, and 
after being checked for logical inconsistencies, are translated to an inter- 
mediate language which describes the operations necessary to perform the 
function(s) contained in the original JOVIAL statement, JALLZ then produces 
a Variable Definition Table entry for each item of variable data referenced 
by the object program,, This table of definitions is derived from either of 
two sources ~~ the Master Comp&oJ. associated with this test, or a definition 
contained in the JOVIAL object program. Once the total operating environ- 
ment has been defined, it is possible to efficiently allocate core storage 
to the various tables and items „ The Variable Definition Table is updated 
to reflect these storage addresses. The Master Compool is used to supply 
definitions for all data not defined in the JOVIAL object program. The 
option exists, on the test control card, of choosing one of the several 
Master Compools contained on the System Master Tape as the data definition 
source for this particular test, thus allowing testing of the JOVIAL-coded 
programs with the various versions of system Compools. Another option 
available on the test control card allows the introduction of revisions to 
the JOVIAL program deck through the card reader. This allows prestored input 
tapes to be updated without having to prestore the entire input array. 
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The Assemble Baby Compool Program, JABCZ, operates next. Using 
the Intermediate Language Tables and the data definitions constructed by 
JALLZ, JABCZ constructs the Baby Compool. This Compool contains information 
relating solely to the data referenced by the JOVIAL object program under 
test, and provides a control medium for use by the Data Simulation and the 
Data Processing Programs, The Baby Compool is saved on tape for later system 
use. 

The next program to operate in the test sequence is the Data 
Simulation Program, JSTRZ. This program provides the controlled environment 
necessary for program testing. The predicted final values of data acted on 
by the object program may also be introduced through JSTRZ. 

The Second Pass of the Interpreter Program, JOLLZ, now operates. 
The Intermediate Language statements are sequentially decoded, and the 
indicated operation is performed. These operations may be arithmetic, data 
storage, or transfers to some nthe** s+.n+.pmprit - The f-inai ^11+™-,+ ~^r.A~*-~ 
of data that the object program would normally produce. Another feature 
of JOLLZ is that it assists the Data Processing Program in the performance 
of the interpretive trace function,, A buffer tape containing dynamic 
"snapshots" of certain interpretive operations is produced for later use 
by the Data Processing Program. 

The last system subprogram to operate is the Data Processing 
Program, JDSYZ. This produces output which includes an English language 
translation of the Intermediate Language Tables, definitions of all data 
referred to by the program, final values of all data, and initial and final 
values where previously introduced. An internal comparison is made of all 
data where expected values are present. These expected values are compared 
to the final values and, where differences exist, a search is made to 
determine the Intermediate Language statement (s)' which store(s) values 
into this data location. These statements are output for debugging pur- 
poses. Another output is a dynamic trace of the interpretive execution 
of the Intermediate Language. Output data for all tests is stacked on 
magnetic tape for off-line printing. 
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MASTER TAPE 



JIS, complete and autonomous, is self-contained on its own physical 
tape, hereafter referred to as the System Master Tape. There are eight sub- 
programs comprising JIS, each of which forms a file on the Master Tape. There 
is also a control area, which along with one of the eight subprograms, JTCPZ 
constitutes the first file on the Master Tape. This file, when read in, is 
permanently affixed in the low part of core. All other subprograms are read 
in from the Master Tape by JTCPZ, control branched to each in turn, and 
scratched from core by the next operating subprogram. The order of files 
need not be in the sequence of program operation. There is, however, the 
mandatory feature that the first file must be the permanent core configura- 
tion. This prerequisite is justified by the "Load-from-Tape" action 
implemented in the tape-loading function of JMSTZ. In initiating the system 
operation, the »Load-f rom-Tape" button on the console is depressed and the 
first file on the Master Tape is read into core. The first record of this 
file is the "Load-tape-into-core" record which, in effect, initiates the 
reading of the control area into. core. The "END" card of this file is an 
unconditional branch to the first operating instruction of the Test Control 
Program, JTCPZ. From this initiating control point, the system cycles through 
the sequential order of operating subprograms. 

Compool outputs from JAMCZ are also stored as separate files on the 
Master Tape. There is the possibility of having any number of Compools on 

vil© UeipG « 
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FORMAT OF MASTER TAPE 



Each program file except the first file is made up of two records. This 
exception contains one other record, the "Load-tape-into-core" record. 



"Load-tape-into-core" record 



EOR 



First File 



Program Ident in Binary-coded Hollerith 
IORP Y, , C 



EOR 



First word of program 

> 

C-l word of program 

"END" Card 



Y - Starting address 
of program 

C - Number of words 
in next record 



EOR 
EOF 
EOR 



Program Ident in Binary-coded Hollerith 
IORP Y, , C 



EOR 



Second File 



First word of program 

* 

C-l word of program 
"END" Card 



EOR 
EOF 
EOR 



Other program 
files 



Logical End 
of Tape 



Y Y Y Y Y Y 
7 7 7 7 7 7 



EOR 
EOF 



NOTE: Miere individual program coding includes the use of TCD (transfer) 
cards, an end-of -record gap is written on the tape when such a type 
of card is encountered. However, the program sequence is not hindered 
because of this, and the program continues to be loaded as part of 
another record. 
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TAPE ALLOCATIONS 



Tape Description 

Al System Master Tape. 

A2 Pre stored input cards for JTCPZ, JALLZ, JSTRZ, JAMCZ, 

A3 New/partial Compool output from JAMCZ j new Compool 

input to JMSTZ. 

All Prestored binary deck input to JMSTZ. 

Bl All DLO. 

B3 New Master Tape output from JMSTZ. 

CI Internal table output from JALLZ j Baby Compool 

output from JABCZ; Initial Tabsira output from 
JSTRZ. 

C3 Partial Compool input to JAMCZ j new Master Tape 

output from JMSTZ. 

Dl Additional table data output from JALLZ j additional 

table data input to JSTRZ j trace output from 
JOLLZj trace input to JDSYZ. 

D2 Expected Tabsim output from JSTRZ: expected Tabsim 

"input to JDSYZ. 

D3 New Master Tape output from JMSTZ. 
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IDENTIFICATION CONVENTIONS FOR THE JOVIAL INTERPRETER SYSTEM (JIS) 



Program Identification 

Each program will be identified by eight symbols: 



System 



LLL 
Sub- 
program 



L 
Model 



D 
Version 



DD 
Modification 



For the Interpreter System, the first letter is "J." 

The three-letter subprogram identifications are as follows: 



ABC 
ALL 

AMC 
DSY 
MST 
OLL 

STR 
TCP 



Assemble Baby Compool Program 

... Interpreter First Pass — Assemble, expand 
and insert logical language 

Assemble Master Compool Program 

Data Reduction Program 

Tape Loading Program 

Interpreter Second Pass — Operate logical 
language 

Data Simulation Program 

Test Control Program 



For model, version and modification clarification, refer to FN-LO-71-1, 
paragraphs 2.1.U, 2.1.5, and 2.1.6 respectively. 
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The following identification will appear at the beginning of every program. 
The first word will be tagged with the address of the "END" card, and will 
contain a transfer to the first operating instruction of the program. The 
second word will contain the five-letter program identification. The third 
word is the version and modification of the program. Example t 



GO 



TRA 



BCI 



START 

IT TT TT 

1 3 DDD 



START 



BEGIN 



1,7,1 



END 



GO 



NOTE: For JTCPZ, the fourth register must be BCI 1,IM. This allows JMSTZ 

to insert the version number of the Master Tape in this register when 
buiding a new System Master Tape. 

Compool Identification 

Each Compool will be identified by six letters: 



L 
System 



C 
Compool 



L 
Model 



D 
Version 



DD 
Modification 



For the Interpreter System the first letter is "J." 



This method uses one word for identification and allows more than one modification 
of a Compool to be stored on the Master Tape. 

End of Logical Tape 

The logical end of tape used in the Interpreter System will be a two-word record 
containing BCD registers of YYYYIX and 777777 respectively, followed by an EOR 
and an EOF,, The sum of tnese two words will give a maximum register of all ones. 



Last record of last program 



EOR 
EOF 
EOR 



707070707070 
070707070707 



EOR 
EOF 
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OPERATING ENVIRONMENT 



A specific area in core is permanently affixed to contain inter- 
communication, I/O transmission and other helpful assistance routines. All 
subprograms of the system use some part of this configuration. Consequently 
the low part of core, from register to register li037o has been allocated 
to contain this helpful package, which will remain permanently in core 
during system cycling. 



Communication Registers 

Octal 
Address 

31 



Location 
Tag_ 

BILT 



32 



bswt 



33 



3U 



BSTAT 



BVAT 



35 
36 

37 



TRAP2 
COMREG 

MATTBL 



Contents 

Intermediate Language Table (ILT) 
for "B" series. 
Address = absolute address of 

ILT Table. 
Decrement = # cf words in ILT 

Table. 

Switch Table (SWT) for n B» series. 
Address = absolute address of 

SWT Table. 
Decrement = 3 of words in SWT 

Table. 

Status Table (STAT) for "B" series. 
Address = absolute address of 
STAT Table. 

Variable Table (VAT) for "B" series. 
Address = absolute address of 

VAT Table. 
Decrement = # of words in VAT 

Table. 

"N" = Full trace; "N" = Automatic trace, 

Decrement ■ # of words in Baby Compool. 
Address ■= current address of Baby 
Compool . 

Constant Table (CON) 

Address = absolute address of 

CON Table. 
Decrement = # of words in CON 

Table „ 
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Uo 



MATTBL+1 



I»l 



U2 



U3 



hk 






1*6 

Ii7 

50 

52 
53 

5U 



MATTBL+2 



MATTBL+3 



MATTBL+i* 



MATTBL+5 



AiUStUiU 



TRAP! 

PRGID 

TSSI 

DSYLMT 

DATE 
DATE+1 

HPAHAM 



Subscript Table (SUB) 

Address = absolute address 

SUB Table. 
Decrement = # of words in 

SUB Table. 

Variable Table (VAT) 

Address * absolute address of 

VAT Table. 
Decrement - # of words in 
Vat Table. 

Switch Table (SWT) 

Address = absolute address of 

SWT Table. 
Decrement = # of words in 
SWT Table. 

Intermediate language Table ( ILT ) . 
Address = absolute address of 

ILT Table. 
Decrement = # of words in 

ILT Table. 

Statement Lable Table (SLT) 

Address = absolute address of 

SLT Table. 
Decrement = # of words in 
SLT Table. 

Decrement * # of words in table 
area. 

Address = starting address of 
table area. 

"N« = Full trace; - Automatic trace, 

Ident of program now operating. 

Sense Indicator storage. 

Data Processing Table data limit. 

Contents of test. 
Date Card. 

Address of parameters to be used by- 
Interpreter Second Pass, set by 
Interpreter First Pass. 



NOTE: The series »B« notation refers to the location in the environment of JALLZ. 
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Permanent Gore Configuration 

Location 
Tag 

SYSERR 



M SPAN 
M RPAN 
P L323 

SEL 
CHK 



NAT 
K TEST 
M TMDSP 

WRT 

I CRDBCD 
I CDOPTN 
I INP 



Contents 

Any error detected within the helpful package 
causes an automatic transfer to this loca- 
tion „ The test being operated is discontinued 
and a return to the Test Control Program is 
initiatedo 

Routine to save the panel « 

Routine to restore the panel „ 

Routine to convert up to 12 packed BCD 
registers to card image „ 

Routine which will select an I/O unit for the 
programmer after first insuring that the 
channel is free. 

Routine which checks for beginning of tape 
test (BTT), end of tape test (ETT), end- 
of-file test (EOF), and transfer on 
redundancy check (TRC) for the channel 
indicated,, 

Routine which hangs up the program until a 
channel is checked and then returns,, 

Routine which updates the activity on all 
channels „ 

Routine which activates all I/O transmission 
macros „ 

Routine which prints BCD characters both on- 
and off-line depending on the desired output « 

Routine which reads BCD cards from card reader. 

Routine which reads BCD cards prestored on tape,, 

Synonymous with RETAK, This routine reads cards 
from channel a card reader and gives special 
returns for end-of -group and end-of -block „ 



NOTE: 



The Test Control Program (JTCPZ) is also in the permanent core configuration 
along with the communication registers and the routines noted above o For 
technical data on JTCPZ, refer to FN-LO-200,, 
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Sense Indicators 
Bit 
6 

8 



10 



12 

13 
lit 



Name 
JOVIAL cards 

JSTRZ data cards 



Coding 

= no revisions to JOVIAL cards. 

1 = revisions to JOVIAL cards » 

= no revisions to JSTRZ data 
input cards. 

1 = revisions to JSTRZ data input 
cards. 

= no additional initial table data 
on tape. 

1 - additional initial table data on 
tape. 

= no errors in JOVIAL input. 

1 = errors in JOVIAL input. 

= no errors in JSTRZ data inputs. 

1 = errors in JSTRZ data inputs. 

Expected Table Data = no expected results. 

1 = expected results exist on tape. 



JSTRZ date on tape 

JOVIAL error 
JSTRZ data error 



The contents of the sense indicator register is stored in location TSSI by 
JTCPZ prior to the operation of the First and Second Passes of the Interpreter. 
The sense indicator register is restored after the operation of these programs. 

Sense Switches 

Sense Switch 1 set to the down position indicates that all input data to JIS 
is being introduced through the card reader. 

Sense Switch 3 set to the down position indicates that printing, which normally 
would be only off-line, is also on-line. 

Sense Switch f> is set to the down position by the computer operator when it 
becomes obvious that the Sscond Pass of the Interpreter is in a loop. This 
causes JTCPZ to bring in JDSYZ which will process all data in a normal manner. 
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A listing of the symbolic cards for 
permanent core {JCORZ) will be issued as the 
first supplement to this document (FN-LO-199, SI), 
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